Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Configuring Sequence Grabber Components

SGDisposeChannel

The SGDisposeChannel function removes a channel from a sequence grabber component.

pascal ComponentResult SGDisposeChannel 
                              (SeqGrabComponent s, SGChannel c);

s

Specifies the component instance that identifies your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenDefaultComponent or OpenComponent function.

c

Specifies the reference that identifies the channel you want to close. You obtain this reference from the SGNewChannel function, described in the previous section.

DESCRIPTION

You can use this function to remove a channel that you are no longer using. However, you cannot dispose of a channel that is currently active--if you are recording or previewing data, this function returns a nonzero result code.

RESULT CODE

badSGChannel

-9406

Invalid channel specified

SEE ALSO

The sequence grabber component automatically disposes of any open channels when you close your connection to the component, so you do not need to call this function prior to calling the Component Manager's CloseComponent function.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help